home *** CD-ROM | disk | FTP | other *** search
/ Mac Mania 4 / MacMania 4.toast / / Tools&Utilities / uucd-241 / uucd / uucd.rsrc / TEXT_128.txt < prev    next >
Text File  |  1995-06-28  |  7KB  |  166 lines

  1. UUCD 2.4.1 - ¬© 1994-95 Laurent Hagimont, France
  2. E-mail: hagimont@cnam.fr
  3.  
  4. This software is distributed as FreeWare.
  5. It can be distributed freely anywhere, on any support.
  6. It is released on Internet in the info-mac archives.
  7.  
  8. What UUCD can do
  9.  
  10. ‚Ä¢ uuencode data files (resource fork and file infos are ignored)
  11. ‚Ä¢ uudecode single or multipart files - no editing required
  12. ‚Ä¢ uucd also works as a "droplet" for uudecoding
  13. ‚Ä¢ the Drag Manager is supported for uudecoding
  14. ‚Ä¢ uuencoded input sections can come from different files
  15. ‚Ä¢ uuencoded input sections can be rearranged visually
  16. ‚Ä¢ uudecoded output files Type and Creator automatically set (configurable)
  17. ‚Ä¢ split the output file during uuencoding
  18. ‚Ä¢ Binhex and MIME/Base64 support
  19.  
  20. uucd is highly System-7 dependant, but can work without ColorQD.
  21.  
  22. Help!
  23.  
  24. When you're reading news on the Net, you're likely to encounter
  25. messages that contain lines like this:
  26.  
  27. begin 700 foobar.jpg
  28. M_]C_[0$7061O8F5?4&AO=&]S:&]P,BXU.@!(````2```.$))30/I``````!X
  29. M``,```!(`$@``````S("./_T__,#/@)&`T<%>P/@``(```!(`$@``````S("
  30. M.``!````9`````$``0$!``(``2</``$``0`````````````````"`!D!D```
  31. M````0`````````````$`````````````````````.$))30/M```````0`$@`
  32. M```!``(`2`````$``CA"24T#\P``````!P``````````.$))30/T```````2
  33. M`#4````!`"T`````````````.$))30/W```````<``#_________________
  34. M____________`^@``/_N``Y!9&]B90!D@`````#_VP!#``D&!P<'!@D)"0D.
  35. M"@H+#A$/#@X-$AH:%1`5&!D@(!X?'QXB(R@I)20E)2$G*RPL+2\T-#0S+C0T
  36. M-#0T-#0T-#3_P``+"``@`!8!`1$`_\0`T@```04!`0$!`0$``````````P`!
  37. M`@0%!@<("0H+$``!!`$#`@0"!08&"`<##6$!``(1`P0A$C$%05%A$R)Q@3(&
  38. M%)&AL4(C)!528C,TP7*"0P<ED@A3T?!C<S46X:+QLH,F1)-49$7"HW0V%QC2
  39. M5>)E\K.$P]-UX_-&)Y2DA;25Q-3D]*6UQ=7E]59F=H:6IK;&UN;V-T=79W>'
  40. MEZ>WQ]?G]R@X2%AH>(B8J+C(V.CX"1DI.4E9:7F)F:FYR=GI^0H:*CI*6FIZ
  41. MBIJJNLK:ZOK_W0`$``/_V@`(`0$``#\`[3^V)]:.I8&;1TGI8(OLJ]:Y[(W!
  42. MA)`#9X)@ZQIHN4Q.N?6)TULNZB[*8)-;GDB)$$GC77_.5UN#]:>L9?0^I8WH
  43. M%G6<(5#79%C7N'N'8$-.O:?N'__0W_K:V^C^V)9F55FWTL*O<W7Q=KH"?P**
  44. M.LN=A,O9CO=:YY8YAG:PZ<N#3IX::H'2SF#J76LDU^[[/CNVZ_G7#3B>&^$^
  45. M2__1]"^N]+L7*P^HTTBRRP_9;0[AS2'%NG](_P`W=<AT7J?4,O#&2RJNPV6>
  46. MUE9:=Y)UWB1M#8CY??U&.;Z?JGE]4#&_:LA]<\[/39=`/P@DSX:K_]+L.KXG
  47. MUNZ[]8<OI-N_&Z0]SO4N#6[35#"STW0#O)D$=M3Q"-TCZD9G3VMH#\=M?N#K
  48. DJMPL#2?S6Q`,:#73S7:?8\7[#]C])OV;T_2]/MLB(^$:+__9
  49. `
  50. end
  51.  
  52. This is a file, named 'foobar.jpg', uuencoded so that it could be sent
  53. as text message(s), in one part or several ones, in different messages.
  54.  
  55. To decode these files, you first have to save the messages, into one or
  56. several files, it doesn't matter. All you have to do next is to drag and
  57. drop your message files on the uucd application icon (or open them
  58. from uucd's file menu, but it can be much longer if you have many files).
  59.  
  60. As the message files are loading, each segment of uucode shows up
  61. as an icon with some textual info on the right. When some consecutive
  62. segments seem to form together a file (the first segment shows up
  63. as a 'begin' icon, the last one as a 'end' icon), the icons of this stream
  64. of segments are changing to outlined ones, with a 'save' mini-icon
  65. at the left of the 'begin' icon. Then you can save the file by clicking
  66. on this 'save' mini-icon.
  67.  
  68. If the segments are in a wrong order, you can rearrange it by 'drag
  69. and drop' on every misplaced segment. The textual infos at the right
  70. of the segment icons are here to help you to identify the segments.
  71. A first column shows the destination filename associated with a
  72. 'begin' segment. The second one gives the last 'Subject:' encountered
  73. while processing the messages. If there is no subject line then the
  74. source file name is used, eventually followed by a number.
  75.  
  76. The 'Sort' button can help you to rearrange automatically the segments
  77. in the proper order. It is designed to work as well as possible in most
  78. simple cases, no more.
  79.  
  80. When Binhex files are encountered, they are loaded but saved only
  81. in their .hqx text form. uucd then only works as a merging tool.
  82. You can use StuffIt Expander or other Binhex decoders to decode
  83. the .hqx file.
  84.  
  85. When MIME/Base64 files are encountered, they are fully decoded.
  86. uucd also tries to guess the file name from the last subject line.
  87. I couldn't find a good, real documentation about this format, and
  88. there seems to be several idioms of it. I can only say that it worked
  89. quite well these last days, on some f*%/=ng base64 posts found
  90. in the news.
  91.  
  92. Troubleshooting
  93.  
  94. ‚Ä¢ uucd doesn't recognize any line of an uuencoded file
  95.  
  96. Are you sure that it's uucode? Some email programs send
  97. attachments in other formats. uucd may not handle them.
  98.  
  99. ‚Ä¢ uucd can't decode MIME/base64 lines
  100.  
  101. Oh, well, maybe uucd isn't so perfect. You can try MPack
  102. (available by anonymous ftp to ftp.andrew.cmu.edu, directory
  103. /pub/mpack).
  104.  
  105. ‚Ä¢ uucd reads my uucode files, but I don't get any uudecoded one
  106.  
  107. Uh... ok, uucd has read the uucode and converted it to binary
  108. segments, but you didn't even try to save them, didn't you ?!
  109. Try the 'Save All' button at the bottom of the window, or the
  110. little disk icon at the topleft of each complete list of segments.
  111.  
  112. ‚Ä¢ You get a 'The application's free memory seems to get low' alert
  113.  
  114. uucd uses the application's memory to  store the uudecoded segments.
  115. When trying to decode large files, there may be insufficient memory
  116. allowed to uucd.
  117.  
  118. To change it, quit uucd, select the application's icon from the
  119. Finder and ask 'Get Info' from the 'File' menu. There you can
  120. change the amount of memory available to uucd.
  121.  
  122. Disclaimer
  123.  
  124. #include <stddisclaimer.h>
  125. /* use it at your own risks, blah blah... */
  126.  
  127. I wrote uucd to suit my personal needs.
  128.  
  129. There are many other uudecoders for the Mac, uucd simply does
  130. everything I've always wanted the others to do, no more.
  131. So if uucd doesn't suit your needs, you can email me or try
  132. another decoder.
  133.  
  134. Version History
  135.  
  136. 950627 uucd 2.4.1 mainly fixes a bug in the prefs mechanism
  137. 950614 uucd 2.4 adds support for Binhex and MIME/Base64
  138. Preferences are now saved in a 'uucd prefs' file in the system prefs folder
  139.  
  140. 950327 uucd 2.3.1 introduces a new 'Sort' button
  141. 950321 uucd 2.3 supports Drag Manager, gets some buttons,
  142. a Memory Bar, and implements a much better 'Save All' mechanism
  143.  
  144. 950301 uucd 2.2.1 fixes some minor problems
  145. 950201 uucd 2.2 has been partially rewritten:
  146. Enhanced the UU lines recognition
  147. Gives better information about each segment
  148.  
  149. 941221 uucd 2.1.8 allows to specify the 'Subject:' tag
  150. 941220 uucd 2.1.7 makes it run without ColorQuickDraw (ie MacSE)
  151. 941208 uucd 2.1.6 fixes a DisposeResource bug
  152. 9412 uucd 2.1.5 posted to comp.binaries.mac
  153.  
  154. 94?? uucd 2.0 posted on the French site CalvaCom
  155. 92?? uucd 1.0 posted on the French site CalvaCom
  156.  
  157. Thanks to
  158.  
  159. emr999@arts.usask.ca (Blue Savannah!)
  160. NavonodM@aol.com (Mark Donovan)
  161. Jeremy@vms.huji.ac.il (Jeremy Moskovich)
  162. gero.dittmer@clipper.de (Gero Dittmer)
  163. cpicket@eis.calstate.edu (Chris S Pickett)
  164. Per.Mildner@CSD.UU.SE (Per Mildner)
  165.  
  166.